package com.danciyixue.boot.dcyx.service;

import com.danciyixue.boot.dcyx.model.entity.UserCurrentUnits;
import com.danciyixue.boot.dcyx.model.form.UserCurrentUnitsForm;
import com.danciyixue.boot.dcyx.model.query.UserCurrentUnitsQuery;
import com.danciyixue.boot.dcyx.model.vo.UserCurrentUnitsVO;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;

/**
 * 用户当前选择单元信息服务类
 *
 * @author youlaitech
 * @since 2025-06-15 16:36
 */
public interface UserCurrentUnitsService extends IService<UserCurrentUnits> {

    /**
     *用户当前选择单元信息分页列表
     *
     * @return {@link IPage<UserCurrentUnitsVO>} 用户当前选择单元信息分页列表
     */
    IPage<UserCurrentUnitsVO> getUserCurrentUnitsPage(UserCurrentUnitsQuery queryParams);

    /**
     * 获取用户当前选择单元信息表单数据
     *
     * @param id 用户当前选择单元信息ID
     * @return 用户当前选择单元信息表单数据
     */
     UserCurrentUnitsForm getUserCurrentUnitsFormData(Long id);

    /**
     * 新增用户当前选择单元信息
     *
     * @param formData 用户当前选择单元信息表单对象
     * @return 是否新增成功
     */
    boolean saveUserCurrentUnits(UserCurrentUnitsForm formData);

    /**
     * 修改用户当前选择单元信息
     *
     * @param id   用户当前选择单元信息ID
     * @param formData 用户当前选择单元信息表单对象
     * @return 是否修改成功
     */
    boolean updateUserCurrentUnits(Long id, UserCurrentUnitsForm formData);

    /**
     * 删除用户当前选择单元信息
     *
     * @param ids 用户当前选择单元信息ID，多个以英文逗号(,)分割
     * @return 是否删除成功
     */
    boolean deleteUserCurrentUnitss(String ids);

    /**
     * 根据用户ID获取当前选中单元
     *
     * @param userId 用户ID
     * @return 用户当前选中单元信息
     */
    UserCurrentUnitsVO getCurrentUnitByUserId(Long userId);

    /**
     * 更新用户当前选中单元
     *
     * @param form 用户当前单元表单数据
     * @return 是否更新成功
     */
    boolean updateCurrentUnit(UserCurrentUnitsForm form);

    /**
     * 标记单元学习完成
     *
     * @param unitId 单元ID
     * @return 操作结果
     */
    boolean completeUnit(Long unitId);

    /**
     * 根据单元学习统计信息更新用户当前单元
     * 当单元学习统计信息发生变化时，同步更新用户当前单元表
     *
     * @param userId 用户ID
     * @param unitId 单元ID
     * @return 是否更新成功
     */
    boolean updateCurrentUnitFromStats(Long userId, Long unitId);
}
